Standardizing Our School's Timetable ⏰📅

We are proud to present our timetable scraping project, the result of collaboration between two passionate developers. Our goal? To improve the retrieval and presentation of timetable data, providing a faster and more efficient solution.

🚀 What is our project for?

Imagine being able to quickly access your timetable, without the constraints of the current system. Our service retrieves data in the blink of an eye and generates an .ics file compatible with Google Calendar, ensuring an automatic update every 6 hours.

🔧 Installation in a Few Steps

1. Go to Google Calendar.
2. Head to the settings.
3. Select "Add a calendar", then "From URL".
4. Enter the following URL, adjusted with your personal information:

   https://calendar.lightin.io/v1/month?firstname=YOUR_FIRSTNAME&lastname=YOUR_LASTNAME&format=icalendar
   

Your timetable will automatically update about every 6 hours.

🌐 Contribute to Continuous Improvement!

Although our project is collaborative, so far, only two developers have contributed. We encourage the participation of the student community, both current and future. Our project is open-source and available on GitHub. Forking the project, submitting pull requests, or creating issues are ways to contribute.

🏗️ Technical Architecture

Explore our technical architecture illustrated in the README of the project. Our code, utilizing FastAPI, Python, and icalendar, simplifies the process of scraping, converting to iCal file, and integration with Google Calendar. Asynchronous requests and efficient error handling ensure an optimal user experience.

We hope our tool will simplify your academic life and allow you to spend more time on what matters.

Thank you for your interest and do not hesitate to contribute to our mission of continuous improvement.

Best of luck! 🌟🎓

---